Developer Documentation

QuickTime 4 API Documentation

Inside Macintosh: QuickTime

Previous | Overview | Contents | Next |

Text Functions

You can use the MyTextProc function described in this section to pass a handle to a specified sample containing formatted text, along with the movie in which the text is being displayed, a pointer to a flag variable, and your reference constant. You specify the desired operations on the text and return an indication of whether you want to display the text in the displayFlag parameter.

MyTextProc

Your text function should have the following form:

pascal OSErr MyTextProc (Handle theText, Movie theMovie,
                                         short *displayFlag, long refcon);
theText
Contains a handle to the formatted text.

theMovie
Specifies the movie for this operation.

displayFlag
Contains a pointer to one of the following flags, which specify how you want the text media handler to proceed when your function returns. The three possible return values for the flag are:

txtProcDefaultDisplay
Indicates that the media should follow the instructions of its own displayFlag constants.

txtProcDontDisplay
Tells the media not to display the text.

txtProcDoDisplay
Instructs the media to display the text regardless of the media's own displayFlag constants.

refcon
Contains the reference constant to your text function.

© 1999 Apple Computer, Inc.

Previous | Overview | Contents | Next